Profile image forGray Brooks

Gray Brooks

GSA

Latest content by Gray Brooks

An Introduction to HTTPS, by 18F and DigitalGov University

18F uses HTTPS for everything we make, and the U.S. government is in the process of transitioning to HTTPS everywhere. As part of this effort, we’ve recently partnered with DigitalGov University to produce a two-video series introducing the why’s and how’s of HTTPS. In an Introduction to HTTPS for beginners, we cover what happens when

Jul 21, 2015

Take a Gander at Our /Developer Page!

A growing trend both inside government and outside is to have a simple welcoming page for outside developers who may be interested in your team’s efforts. This material is often located at website.gov/developer 1 and points visitors to technical material that developers may be interested in, especially APIs. Collecting technical documentation in one place facilitates

Jul 28, 2014

Packaging Up API Usability Testing for Agency Reuse

Over the past year, a GSA collaboration has seen a project that offers API Usability Testing to federal agencies go from the pilot stage to a regular, robust series. Already, 13 agencies and programs have participated, and several more participate with every monthly session

May 20, 2014

API Security

Like website development, API security revolves around three stages—planning the API, testing the API, and monitoring the API after it has launched. The planning stage requires those involved to conceptually map several design decisions and the impact that they will have on security. The second stage applies your agency’s security program to the API release

Jul 29, 2013

Develop with Web Standards

What It Is Do you remember the days when web pages had banners announcing that they were “best viewed with browser X”? Veteran web developers and designers certainly do, because they had to consider numerous exceptions for certain browsers and their versions. Today, building websites isn’t as challenging and that’s because developers are moving toward

Jun 30, 2013

/Developer Kit

These are the elements that make up a well-rounded developer hub. Homepage The API efforts of any agency should all be accessible via one easy to reach developers hub. This Web page should provide a path to all public APIs and any associated resources. Once an agency has begun to publish multiple APIs, certain resources

May 21, 2013

API Release Kit

These are the elements you should include in your federal API release. Homepage Each of your public APIs needs a page to serve as a hub to provide access to all information and tools associated with it. By using the page’s sidebar, footer, and sub pages, you can directly include or link to each of

May 16, 2013

We the People API

“APIs for WhiteHouse.gov? What in the heck does that mean?” Like President Obama, you may be asking the same question.

May 09, 2013

APIs in Government

This page is about what an Application Programming Interface or API is and what it does and how government agencies are using them to operate more efficiently.

Apr 30, 2013

Producing APIs through Data.gov

One way agencies can offer APIs for their data is to use the built–in functionality of Data.gov. The information that is hosted as interactive datasets have an API layer which agencies can make available through documentation in the developer’s section of the agency’s website. The guide below will help you do this. Process Upload a dataset

Apr 30, 2013

Usability Testing + Gov APIs = Best

Good APIs can transform intimidating data sets into something that people can use. Good government APIs can create a better connection between government and citizens. The Digital Government Strategy has spurred Federal adoption of APIs, and the Digital Services Innovation Center and DATA.GOV teams are supporting these efforts by releasing a swath of guidance and

Apr 29, 2013

API Analytics

Similar to website analytics, API analytics focus on reliably reporting the metrics which are most useful to its stakeholders. There are a many ways of collecting, reporting, and consuming API analytics but all revolve around the industry–accepted norm that some form of analytics are crucial to any API program. The most basic metrics will track

Mar 12, 2013

API Design and Documentation

Design At their core, developers want APIs for very straightforward, pragmatic ends. You should always design your APIs and document them with the goal of making it easier for developers to use them. Doing so results in greater adoption and a healthier, more successful API. The least efficient way to support developers would be to

Mar 12, 2013

How to Make APIs—An Overview

After choosing a set of information or services to offer via API, some of your next steps are to plan and implement the API. You’ll still need to prepare documentation, tools, and other elements that make a complete package for the API, but at the center is the actual Web service itself. In many situations,

Mar 12, 2013